.\"
.\" Copyright (C) 1994-2021 Altair Engineering, Inc.
.\" For more information, contact Altair at www.altair.com.
.\"
.\" This file is part of both the OpenPBS software ("OpenPBS")
.\" and the PBS Professional ("PBS Pro") software.
.\"
.\" Open Source License Information:
.\"
.\" OpenPBS is free software. You can redistribute it and/or modify it under
.\" the terms of the GNU Affero General Public License as published by the
.\" Free Software Foundation, either version 3 of the License, or (at your
.\" option) any later version.
.\"
.\" OpenPBS is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public
.\" License for more details.
.\"
.\" You should have received a copy of the GNU Affero General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
.\"
.\" Commercial License Information:
.\"
.\" PBS Pro is commercially licensed software that shares a common core with
.\" the OpenPBS software.  For a copy of the commercial license terms and
.\" conditions, go to: (http://www.pbspro.com/agreement.html) or contact the
.\" Altair Legal Department.
.\"
.\" Altair's dual-license business model allows companies, individuals, and
.\" organizations to create proprietary derivative works of OpenPBS and
.\" distribute them - whether embedded or bundled with other software -
.\" under a commercial license agreement.
.\"
.\" Use of Altair's trademarks, including but not limited to "PBS™",
.\" "OpenPBS®", "PBS Professional®", and "PBS Pro™" and Altair's logos is
.\" subject to Altair's trademark licensing policies.
.\"
.TH pbs_ds_password 8B "6 May 2020" Local "PBS Professional"
.SH NAME
.B pbs_ds_password 
\- set or change data service user account or its password
.SH SYNOPSIS
.B pbs_ds_password 
[-C <username>] [-r]

.SH DESCRIPTION
You can use this command to change the user account or account password 
for the data service.  

.B Passwords
.br
Blank passwords are not allowed.

If you type in a password, make sure it does not contain restricted
characters.  The 
.B pbs_ds_password
command generates passwords
containing the following characters:

0123456789abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ!@#$%^&*()_+

When creating a password manually, do not use \\ (backslash) or `
(backquote). This can prevent certain commands such as pbs_server,
pbs_ds_password, and printjob from functioning properly, as they rely
on connecting to the database.  

.B Permissions
On Linux, root privilege is required to use this command. On Windows, 
Admin privilege is required.

.B Restrictions
Do not run this command if failover is configured. It is important 
not to inadvertently start two separate instances of the data service 
on two machines, thus potentially corrupting the database.
If failover is configured, stop the secondary server, remove
definitions for PBS_PRIMARY and PBS_SECONDARY from pbs.conf on the
primary server host, start PBS, run pbs_ds_password, stop PBS, replace
the definitions, and start PBS again.

.SH OPTIONS

.IP "-C <username>" 15  
Changes user account for data service to specified account.  Specified
user account must already exist. 
.br

On Linux-based systems, the specified user account must not be root.
.br

On Windows, the specified user account must match the PBS service
account (which can be any user account.)
.br

This option cannot be used while the data service is running. 
.br

Can be used with the 
.I -r
option to automatically generate a password
for the new account.

.IP "-r" 15
Generates a random password. The data service is updated with the new
password. 

Can be used with the -C option.

.IP "(no options)" 15
Asks the user to enter a new password twice. Entries must
match. Updates data service with new password.


.RE
.RE
.RE
.RE
.LP

.SH EXIT STATUS
.IP "Zero" 15
Success
.IP "Non-zero" 15
Failure
